home *** CD-ROM | disk | FTP | other *** search
/ Commodore 64 Scene Diskmags Assortment / Commodore_CEE_Vol._1_Issue_06_1995_Jack_Vander_White_Disk_1_of_3_Side_A.d64 / geofamly.sfx / geofamily doc (.txt) < prev    next >
GEOS ConVerT  |  1990-02-12  |  15KB  |  255 lines

  1. gEOfAMILY dOC
  2. prg FORMATTED geos FILE v1.0
  3. hq9 MED ePS gc
  4. 28 v2.0 OR HIGHER1
  5. family.f1
  6. blaster's converter v2.5
  7. family.f2
  8. gEOfAMILY ad-2
  9. wRITE iMAGE v2.1
  10. GEOwRITE    v1.1
  11. *uSE fONT fOR docs TO PRINT.
  12.  @geofamily (C) 1991, 1992  dAVID c. lUCAS
  13. wELCOME!  
  14.  @gEOfAMILY
  15.  IS A FAMILY AND RELATION DATA-BASE DESIGNED TO BE A SIMPLE ADDRESS/PHONE BOOK, TO WHICH i HAVE ADDED A NUMBER OF USEFUL FEATURES.
  16. yOU SHOULD HAVE 
  17.  @gEOfAMILY
  18.  AND THE 4 DATA FILES ON THE SAME DISK, AS 
  19.  @gEOfAMILY
  20.  WILL LOOK FOR THE DATA FILES ON THE SAME DRIVE/DISK THAT IT WAS STARTED FROM.
  21. note: 
  22. BEFORE USING 
  23.  @gEOfAMILY
  24.  FOR THE FIRST TIME MAKE A BACKUP OF THE DISK.  aLWAYS USE THE BACKUP COPY AND KEEP THE ORIGINAL IN A SAFE PLACE.  tHE 4 FILES (family.p1, family.p2, family.f1, family.f2) ARE USED TO SAVE THE DATA.  bY KEEPING THE ORIGINALS UNTOUCHED YOU CAN CREATE ADDITIONAL FAMILY DISKS IN THE FUTURE.  sINCE THE DATA FILES GET UPDATED A LOT YOU WILL ALSO WANT TO MAKE A BACKUP OF THESE FILES ON A REGULAR BASIS.  oF COURSE, YOU MAY COPY THE PROGAM AND DATA FILE TO A rAM eXPANSION dRIVE AND RUN IT FROM THERE!
  25. screen layout:
  26. oNCE LOADED, YOU WILL SEE THE MAIN MENU AS WELL AS 3 LARGE RECTANGULAR WINDOWS;
  27.  @rEC1
  28. ' IS A TALL-NARROW WINDOW TO THE LEFT,
  29.  @rEC2
  30. ' IS TO THE UPPER RIGHT, AND
  31.  @rEC3
  32. ' IS TO THE LOWER RIGHT.
  33.  @rEC1
  34.  WILL SHOW AN ABBREVIATED LIST OF EACH PERSON YOU HAVE ENTERED; 5 LETTERS OF THEIR LAST NAME AND THEN 8 LETTERS OF THEIR FIRST NAME.  10 NAMES CAN BE SHOWN AT ONCE.  mORE NAMES MAY BE SCROLLED USING 4 OF THE 6 ICONS BELOW THE WINDOW.  tHERE IS 
  35. down5
  36.  AND 
  37. bottom
  38. .  cLICK OVER ANY NAME SELECTED TO MAKE IT THE CURRENT PERSON.
  39. note: 
  40. CURRENT PERSON 
  41.  IS IN 
  42.  @bold
  43.  TEXT.
  44.  @rEC2
  45.  IS A WINDOW THAT SHOWS VARIOUS SETS OF DATA.  iT IS DESCRIBED IN MORE DETAIL LATER.
  46.  @rEC3
  47.  SHOWS WHICH PEOPLE, FROM THE 
  48.  @rEC1
  49.  LIST, ARE IN EACH FAMILY.  tHE TOP LINE OF 
  50.  @rec3
  51.  SHOWS THE VERSION NUMBER AND THE STRINGS 'p=000' AND 'f=000'.  tHESE NUMBERS REFLECT THE RECORD NMBERS AND ARE THERE JUST FOR CURIOSITY!  yOU MUST PLACE THE HUSBAND IN THE TOP LEFT SEGMENT OF THE WINDOW AND THE WIFE IN THE TOP RIGHT SEGMENT.  cHILDREN MAY GO INTO ANY OF THE REMAINING SEGMENTS.
  52. adding people & families:
  53. tO ADD PEOPLE, SELECT person-new.  a SERIES OF DIALOG BOXES WILL COME UP REQUESTING PERTINENT INFORMATION.  iF YOU SELECT THE cancel BUTTON, YOU AVOID ALL REMAINING DATA ENTRIES BUT DO NOT LOSE DATA ENTERED OR CHANGES MADE.  rEPEAT AS NEEDED FOR EACH PERSON.
  54. tO CREATE A FAMILY, SELECT family-new.  aGAIN, dbS WILL ASK FOR INFORMATION.  eNTER ONLY THAT WHICH YOU KNOW.  mORE CAN BE ADDED LATER, OR THE DATA CHANGED,  USING THE EDIT COMMAND. sELECT A CURRENT PERSON IN 
  55.  @rEC1
  56.  BY CLICKING ON THE NAME AND POINT TO A BLANK SPOT IN 
  57.  @rEC3
  58.  THAT YOU WISH TO PLACE THAT PERSON (HUSBAND AND WIFE TOP LEFT AND RIGHT RESPECTIVELY).  cLICK AND THE NAME IS PLACED.  tHE FILES ON DISK WILL BE UPDATED AUTOMATICALLY AS NEEDED.
  59. yOU WILL SEE THAT rec3 ALLOWS 2 PARENTS AND UP TO 12 CHILDREN.  nEED MORE?  sIMPLY MAKE A NEW FAMILY WITH THE SAME 2 PARENTS AND THE 'LEFT-OVER' KIDS.  aDOPTED OR fOSTER KIDS CAN BE ENTERED JUST LIKE NATURAL CHILDREN, BUT THEY WILL HAVE A DIFFERENT LAST NAME.
  60. iF YOU SHOULD PLACE A NAME IN THE WRONG SECTION OF 
  61.  @rEC3
  62. , MAKE SURE THE NAME IS SELECTED IN 
  63.  @rEC3
  64.  AND SELECT person-erase.  tHIS WILL ERASE THAT PERSON FROM THE 
  65. CURRENT FAMILY ONLY
  66.   - NOT FROM 
  67.  @rEC1
  68. 'S LIST.  bE SURE THAT YOU HAVE SELECTED THE PERSON TO BE ERASED BY CLICKING ON HIM/HER IN 
  69.  @rEC3
  70.  @NOT rEC1
  71. !  yES, PERSONS MAY BE
  72. SELECTED IN 
  73. g@rEC3
  74.  AS WELL AS IN 
  75. g@rEC1
  76. aLL DATES THAT ARE TO BE ENTERED SHOULD HAVE THE FORMAT: 2 DIGITS DAY, 3 LETTERS MONTH, 4 DIGITS YEAR: DDMMMYYYY.
  77. nOTE: 
  78. ONCE YOU HAVE ENTERED A PERSON INTO 
  79. g@rEC1
  80. , YOU MAY NOT REMOVE THAT PERSON.  rATHER, YOU MAY edit THE NAME TO CHANGE IT  INTO SOMEONE ELSE.  bE AWARE THAT, ALTHOUGH YOU CAN edit A PERSON'S NAME, THEY WILL STILL BE LINKED TO THE APPROPRIATE FAMILIES, IF THAT HAD BEEN DONE EARLIER.  iF YOU
  81.  NEED TO CHANGE THESE LINKS, USE erase!
  82. nOW YOU SHOULD BE ABLE TO ENTER NEW PEOPLE AND NEW FAMILIES TO THE DATA-BASE.  
  83. rec2:
  84. aS i MENTIONED ABOVE, 
  85. g@rEC2
  86.  SHOWS ALL ENTERED DATA FOR THE CURRENT PERSON.  wHERE IS THE DATA FOR THE FAMILY?  aDDRESS AND PHONE NUMBERS, ETC.? cLICK ANYWHERE WITHIN 
  87. g@rEC2
  88. .  tHIS
  89. CURRENT PERSON.  wHERE IS THE DATA FOR THE FAMILY?  aDDRESS AND PHONE NUMBERS, ETC.? cLICK ANYWHERE WITHIN 
  90.  @rEC2
  91. .  tHIS WILL CAUSE IT TO CYCLE THROUGH THREE SETS OF DATA,
  92.  @pERSON
  93. -fULL NAME, BIRTH AND DEATH DATE, ENTERED TEXT
  94.  @fAMILY
  95. -aDDRESS, POSTAL, PHONE, AND WEDDING DATE
  96.  @tRACE
  97. -tHE RELATION BETWEEN THE 'TRACE' PERSON AND THE CURRENT PERSON.
  98.  @note
  99. : THE DISPLAY IN 
  100.  @rEC2
  101.  MAY ALSO BE SELECTED AT toggles-vIEW rec2.
  102. navigation:
  103. mOST DATA-BASES PERMIT VIEWING THE NEXT OR PREVIOUS RECORD, OR IN THIS CASE,  FAMILY.  tHESE FUNCTIONS ARE AVAILABLE IN 
  104.  @gEOfAMILY
  105.  UNDER THE family MENU.  tHEY ARE PLACED AT THE BOTTOM BECAUSE YOU PROBABLY WON'T BE USING THEM OFTEN.  rATHER, USE 
  106.  AND 
  107.  WILL BRING UP THE 
  108. FIRST 
  109.  FAMILY CONTAINING THE CURRENT PERSON.  
  110.  WILL FIND THE 
  111.  FAMILY CONTAINING THE CURRENT PERSON THAT IS HIGHER THAN THE CURRENT FAMILY.  iF THERE ARE NONE HIGHER, YOU WILL GET THE FIRST OCCURRENCE, JUST AS IN 
  112. .  rECALL, i MENTIONED THAT THERE ARE 6 ICONS BELOW 
  113.  @rEC1
  114. , BUT i HAVE ONLY TOLD YOU ABOUT 4.  tHE OTHER 2 ARE 
  115.  AND 
  116. .  tHEY MAY BE MORE CONVENIENT THAT USING THE MENUS.
  117. yOU KNOW HOW TO SELECT DIFFERENT PEOPLE AND SIMPLE NAVIGATION IS PROVIDED WITH THE 4 ICONS ON-SCREEN.  tHERE IS A MUCH MORE DETAILED METHOD OF LOCATING A SPECIFIC PERSON OR FAMILY FOR THAT MATTER.  wITH BOTH person-find AND family-find, YOU MAY SEARCH ON ANY ONE OF THE ENTERED FIELDS.  cURRENTLY, ONLY 
  118. EXACT
  119.   MATCHES, AT THE START OF THE DATA, WILL BE LOCATED.  sEARCHING STARTS WITH THE RECORD FOLLOWING THE CURRENT RECORD AND, IF NO MATCH IS FOUND, TERMINATES AT THE RECORD BEFORE THE ONE STARTED AT.  sEARCHING ALSO TERMINATES AT THE FIRST RECORD FOUND WITH A MATCH.  tHIS MATCHING PERSON, OR FAMILY, WILL THEN BE THE CURRENT RECORD ON EITHER TERMINATION.
  120. iF AT ANY TIME, YOU HAVE SELECTED A PERSON, THEY MAY NOT BE VISIBLE WITHIN THE CURRENT 
  121.  @rec1
  122. .  sHOULD YOU WISH TO CHANGE THE VIEW SO THAT IT INCLUDES THE CURRENT PERSON, MERELY SELECT person-show.
  123. print menu:
  124. eACH PRINT MODULE WILL OUTPUT IN ONE OF THREE MODES.  tHESE CAN BE SELECTED WITH 
  125. print-output.to
  126. .  tHE DEFAULT IS TO SCREEN.  tHE OTHERS ARE TO TEXT SCRAP AND TO PRINTER.  fORMATTING IS MAINTAINED IN ALL 3 MODES.  iF SCREEN IS SELECTED, A db WILL SHOW YOU THE FIRST 10 LINES OF THE GIN TEXT.  tHERE IS 5 ICONS, TO SCROLL 
  127.  TO EXIT, 
  128. scissors
  129.  TO COPY TO A TEXT SCRAP AND A 
  130. printer
  131. dATA DISPLAYED IS AS FOLLOWS: IF ADDRESS, ETC.; ONE FIELD PER LINE.  aND IF A PERSON; fIRST, iNITIAL, lAST, bIRTHDAY, AND aGE IN THE YEAR SELECTED.
  132. desk accessories:
  133. iMPORTANT: 
  134.  dESK ACCESSORIES HAVE 
  135. LIMITED 
  136.  SUPPORT WITH VERSION 2.5.  i SUGGEST THAT IF YOU WISH TO USE daS, QUIT FROM 
  137.  @gEOfAMILY
  138.  (THIS WILL INSURE THE DATA FILES ARE UP-TO-DATE)  tHEN, WITH THE daS ON THE DISK, RESTART 
  139.  @gEOfAMILY
  140. .  tRY EACH ONE.  sOME daS WILL NOT
  141. START, SOME WILL RUN BUT WILL
  142.  not RESTORE THE PROGRAM PROPERLY.  tHEY MAY PRODUCE A COMPLETE SYSTEM CRASH!  rEASON;  i CANNOT LOCATE INFORMATION ON HOW TO SUPPORT daS!  mAYBE YOU CAN LOCATE SOMEONE OUT YOUR WAY WHO HAS THAT INFORMATION.  iF YOU COULD SEND ME ANY DATA ON HANDLING dESK aCCESSORIES FROM APPLICATIONS AND/OR WHAT IS NEEDED TO CREATE THEM, i WOULD BE 
  143. gpmost 
  144. GRATEFUL ! 
  145. sOME THAT i HAVE TESTED AND ARE ok ARE: cALCULATOR, pREFERENCE mGR, aLARM cLOCK, gEOhEXcALC, dISK uSAGE, gEOmIMIC, gEOsLIDERS, bLACKjACK.  daS THAT WORK BUT CAUSE AESTHETIC DAMAGE (APPEARANCE ONLY TROUBLE): pADcOLORmGR, sKEET, cALENDAR, wRISTWATCH v4.  tHOSE THAT CRASH ON EXIT: nOTEpAD, pHOTOmANAGER AND tEXTmANAGER.
  146. to come.?.:
  147. pATERNAL tREE-sEARCH FOR AND DISPLAY FATHER'S LINE FROM ANY STARTING PERSON.
  148. mATERNAL tREE-sAME BUT WITH MOTHER'S LINE.
  149. fAMILY tREE-cREATE AND PRINT A 
  150. PICTURE 
  151. STARTING PERSON.
  152. mATERNAL tREE-sAME BUT WITH MOTHER'S LINE.
  153. fAMILY tREE-cREATE AND PRINT A 
  154. PICTURE 
  155.  OF THE ENTIRE FAMILY.
  156. comments:
  157. i HAVE DESIGNED 
  158.  @gEOfAMILY 
  159. TO BE FLEXIBLE AND EXPANDABLE.
  160.   fLEXIBLE: 
  161.  @gEOfAMILY
  162.  WILL HANDLE MULTIPLE MARRIAGES (i SUGGEST USING THE MAIDEN NAMES WHEN ENTERING PERSON DATA), AND ADOPTIONS.  uNKNOWN INFORMATION CAN BE SKIPPED UNTIL LATER WITH NO AFFECT ON THE FUNCTIONALITY.  aDOPTIONS ARE ENTERED JUST LIKE A BIRTH CHILD, THEY WOULD JUST HAVE A DIFFERENT LAST NAME.
  163. eXPANDABLE: tHAT MEANS SIMPLY THAT i CAN ADD NEW "MODULES" TO THE PROGRAM AT VIRTUALLY ANY TIME SHOULD ADDITIONAL FUNCTIONS BE REQUESTED OR NEEDED.
  164. tHAT MEANS IF YOU WOULD LIKE TO SEE SOMETHING ADDED, let me know!  i CAN'T THINK OF EVERYTHING! 
  165. i THINK THAT'S IT.  pLEASE ENJOY.  aND LET ME KNOW ABOUT PROBLEMS, OR COMMENTS.  
  166. dAVID c. lUCAS
  167. 8309 29AVE.
  168. eDMONTON, ab.
  169. t6k 3j9
  170. eDMONTON, ab.
  171. t6k 3j9
  172. eDMONTON, ab.
  173. t6k 3j9
  174. e SELECTED A PERSON, THEY MAY NOT BE VISIBLE WITHIN TH 
  175.  AND 
  176. .  tHEY MAY BE MORE CONVENIENT THAT US
  177. menus:
  178. gEOS:
  179. iNFO-AUTHOR AND DATE OF THIS VERSION
  180. daS-DESK ACCESSORIES
  181. fILE:
  182. hELP-PROVIDES A FEW REMINDERS
  183. qUIT-OH, YOU KNOW!
  184. pERSON:
  185. eDIT-CHANGE CURRENT PERSON DATA
  186. fIND-LOCATE BY VARIOUS DATA
  187. sHOW-VIEW THE CURRENT PERSON WITHIN rec1
  188. nEW-ADD A NEW PERSON
  189. eRASE-REMOVE PERSON FROM CURRENT FAMILY.  nOT PEOPLE LIST (
  190.  @rec1
  191. tRACE-MAKE CURRENT PERSON THE STARTING 'TRACE' PERSON
  192. fAMILY:
  193. jUMP-GET NEXT HIGHER FAMILY CONTAINING CURRENT PERSON
  194. gOTO-GET FIRST FAMILY CONTAINING CURRENT PERSON
  195. eDIT-CHANGE CURRENT FAMILY DATA
  196. fIND-LOCATE BY VARIOUS DATA
  197. nEW-ADD A NEW FAMILY
  198. nEXT-GET NEXT HIGHER FAMILY
  199. pREVIOUS-GET PREVIOUS FAMILY
  200. pRINT:
  201. bY mONTH-GET PEOPLE WITH MATCHING BIRTH MONTH
  202. sHORT-GET PEOPLE IN THE CURRENT FAMILY
  203. lONG-GET CURRENT FAMILY DATA AND THEN DO 'SHORT'
  204. aLL-GET APPROX. 70 PEOPLE, STARTING WITH CURRENT PERSON
  205. tOGGLES:
  206. oUTPUT TO-SELECT WHERE TO PRINT TO
  207. rEC2 DATA-SELECT WHAT DATA TO VIEW IN REC2
  208. cHANGE mONTH-SELECT MONTH FOR SEARCHING
  209. cHANGE yEAR-SELECT YEAR, USED TO FIND AGE
  210. mODULES:
  211. mAKE rELATIONS-WILL FIND EVERYONE'S RELATIONSHIP
  212. dIAL fAMILY-CALL THE CURRENT FAMILY, JUST HOLD PHONE HANDSET NEAR SPEAKER ON MONITOR
  213. nOTE: 
  214. IF ANY MENU SELECTION IS IN 
  215. ITALICS
  216. , YOU WILL NOT BE ABLE TO PERFORM THAT FUNCTION UNTILL SOMETHING ELSE HAS BEEN DONE.
  217. nOTE: 
  218. wHEN make relations IS CHOSEN IT CAN TAKE A LONG TIME TO BUILD THE TABLES - BE PATIENT!
  219. LDS.  cURRENTLY, ONLY 
  220. EXACT
  221.   MATCHES, AT THE START OF THE DATA, WILL BE LOCATED.  sEARCHING STARTS WITH THE RECORD FOLLOWING THE CURRENT RECORD AND, IF NO MATCH IS FOUND, TERMINATES AT THE RECORD BEFORE 
  222. some technical points:
  223.  @gEOfAMILY
  224.  SUPPORTS 255 DIFFERENT PEOPLE AND 255 DIFFERENT FAMILIES.  i DID NOT SEE MUCH USE FOR EXPANDING THESE LIMITS.  mAYBE YOU WILL NEED MORE!  iF SO, CREATE ANOTHER DISK, COPY OVER THE PROGRAM AND THE ORIGINAL, EMPTY, FILES 'family.p1', 'family.p2', 'family.f1', 'family.f2', AND CONTINUE ON.  tHESE ARE ALSO vlir FORMATTED FILES, CONTAINING UP TO 127 RECORDS EACH.  rECORD #0 OF family.p1 CONTAINS THE ABBREVIATED LIST FOUND IN 
  225.  @rEC1
  226. .  tHE POSITION OF THE NAME EQUATES TO THE RECORD NUMBER.  fAMILIES ARE STORED IN THE '.f' FILES.  rECORD #0 OF family.f1 BEING UNUSED AT THIS TIME.
  227. iF YOU ARE CURIOUS, i HAVE ONE BYTE WHICH DENOTES THE RELATIONSHIP OF ANY TWO PEOPLE.  tHAT MEANS, IN EACH PERSON RECORD THERE IS 255 BYTES AVAILABLE FOR RELATIONS.  i USE A MODIFIED HASH ALGORITHM TO DERIVE THE APPROPRIATE TEXT.  tHREE BITS COVER 'STEP', 'HALF' AND 'IN-LAWS'.  tHE REMAINDER INDEX TO A TABLE.    ie: fOR A RELATION VALUE 23.   tHIS VALUE WILL PRODUCE THE STRING : 'gREAT-gREAT-gRAND pARENT'.  bUT HOW DO i GET THAT VALUE OF 23?!?!?  nO.  i THINK THAT'S ENOUGH OF MY 'SECRETS'! 
  228. data formats:
  229. aS THE DATA IS IN RECORDS, PATCHES OR OTHER APPLICATIONS WHICH MAY WANT TO USE THE SAME DATA CAN BE READILY DEVELOPED.  sO i SHALL INCLUDE THE DATA FORMATS OF THE pERSON AND fAMILY FILES.
  230. person: bytescontaining
  231. RECORDS$00-$0ClAST NAME;null TERMINATED
  232. 1-255$0D-$19fIRST NAME;null TERMINATED
  233. $1A-$1BiNITIAL;null TERMINATED
  234. $1C-$25bIRTH DATE;SHOULD HAVE FORMAT ddmmmyyyy;null TERMINATED
  235. $26-$2FdEATH DATE;SAME DATE FORMAT;null TERMINATED
  236. $30-$36jUMP TABLE;VALUES OF FAMILIES WITH THIS PERSON
  237. $37-$FFtEXT;null TERMINATED
  238. $0100-$01FFrELATION bYTES
  239. person:sIZE OF EACH PERSON NAME=$0F
  240. RECORD0$00pERSON 0;SINCE IT IS NEVER USED..
  241. $05mAX NUMBER OF PERSONS IN THIS LIST
  242. $06mAX NUMBER OF FAMILIES
  243. $0FpERSON 1, ETC....;null TERMINATED
  244. family:$00hUSBAND; rECORD NUMBER
  245. $01wIFE; rECORD NUMBER
  246. $02-$0DcHILDREN; BYTE VALUES
  247. $0E-$17wEDDING DATE;null TERMINATED
  248. $18-$2CaDDRESS;null TERMINATED
  249. $2D-$40cITY;null TERMINATED
  250. $41-$46pROVINCE;null TERMINATED
  251. $47-$53pOSTAL cODE;null TERMINATED
  252. $54-$pHONE NUMBER;null TERMINATED
  253. S TO SCREEN.  tHE OTHERS ARE TO TEXT SCRAP AND TO PRINTER.  fORMATTING IS MAINTAINED IN ALL 3 MODES.  iF SCREEN IS SELECTED, A db WILL SHOW YOU THE FIRST 10 LINES OF THE GIN TEXT.  tHERE IS 5 ICONS, TO SCROLL 
  254. gEOfAMILY
  255.